home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbfirstrow.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.2 KB  |  50 lines
  1. .Na "DBFIRSTROW" 
  2. .Aa
  3. .Fu
  4. Return the number of the first row in the row buffer.
  5. .Ih "row buffer, returning the number of its first row"
  6. .Sy
  7. .Sf "DBINT DBFIRSTROW(dbproc)"
  8. .Sp "DBPROCESS" "*dbproc"
  9. .Co
  10. .Bl
  11. This macro returns the number of the first row in the row buffer.
  12. .Bl
  13. If you aren't buffering rows, 
  14. .I "DBFIRSTROW(), DBCURROW(),"
  15. and
  16. .I "DBLASTROW()"
  17. always have the same value.
  18. If you \f2have\f1 enabled buffering by setting the
  19. DBBUFFER option,
  20. .I "DBFIRSTROW()"
  21. returns the number of the first row in the row buffer.
  22. .Bl
  23. Note that the first row returned from \*S (whose value is 1)
  24. is not necessarily the first row in the row buffer.
  25. The rows in the row buffer are dependent on manipulation by
  26. the application program.
  27. See the \f2dbclrbuf()\f1 manual page for details.
  28. .Bz
  29. .Pa
  30. .Pi dbproc
  31. A pointer to the DBPROCESS structure that provides the connection
  32. for a particular front-end/\*S process.  It contains all the
  33. information that \*L uses to manage communications and data between the
  34. front end and \*S.
  35. .in -.375i
  36. .Re
  37. .br
  38. The number of the first row in the row buffer.
  39. Rows are counted from
  40. the first row returned from \*S, whose number is 1.
  41. This routine returns 0 if there's an error.
  42. .Sa
  43. dbclrbuf,
  44. DBCURROW,
  45. dbgetrow,
  46. DBLASTROW,
  47. dbnextrow,
  48. dbsetopt,
  49. options
  50.